<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=iso-8859-1">
<title> - The Java EE 5 Tutorial</title>
<meta name="robots" content="index,follow">
<meta name="robots" content="index,follow">
<meta name="date" content="2008-10-01">
<link rel="stylesheet" type="text/css" href="css/default.css">
<link rel="stylesheet" type="text/css" href="css/ipg.css">
<link rel="stylesheet" type="text/css" href="css/j5eetutorial.css">
</head>

<body>

<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tbody>
   <tr valign="top">
      <td><p class="toc level1"><a href="docinfo.html">Document Information</a></p>
<p class="toc level1 tocsp"><a href="gexaf.html">Preface</a></p>
<p class="toc level1 tocsp"><a href="gfirp.html">Part&nbsp;I&nbsp;Introduction</a></p>
<p class="toc level2"><a href="bnaaw.html">1.&nbsp;&nbsp;Overview</a></p>
<p class="toc level2"><a href="gfiud.html">2.&nbsp;&nbsp;Using the Tutorial Examples</a></p>
<p class="toc level1 tocsp"><a href="bnadp.html">Part&nbsp;II&nbsp;The Web Tier</a></p>
<p class="toc level2"><a href="bnadr.html">3.&nbsp;&nbsp;Getting Started with Web Applications</a></p>
<p class="toc level2"><a href="bnafd.html">4.&nbsp;&nbsp;Java Servlet Technology</a></p>
<p class="toc level2"><a href="bnagx.html">5.&nbsp;&nbsp;JavaServer Pages Technology</a></p>
<p class="toc level2"><a href="bnajo.html">6.&nbsp;&nbsp;JavaServer Pages Documents</a></p>
<p class="toc level2"><a href="bnakc.html">7.&nbsp;&nbsp;JavaServer Pages Standard Tag Library</a></p>
<p class="toc level2"><a href="bnalj.html">8.&nbsp;&nbsp;Custom Tags in JSP Pages</a></p>
<p class="toc level2"><a href="bnaon.html">9.&nbsp;&nbsp;Scripting in JSP Pages</a></p>
<p class="toc level2"><a href="bnaph.html">10.&nbsp;&nbsp;JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnaqz.html">11.&nbsp;&nbsp;Using JavaServer Faces Technology in JSP Pages</a></p>
<p class="toc level2"><a href="bnatx.html">12.&nbsp;&nbsp;Developing with JavaServer Faces Technology</a></p>
<p class="toc level2"><a href="bnavg.html">13.&nbsp;&nbsp;Creating Custom UI Components</a></p>
<p class="toc level2"><a href="bnawo.html">14.&nbsp;&nbsp;Configuring JavaServer Faces Applications</a></p>
<p class="toc level2"><a href="bnaxu.html">15.&nbsp;&nbsp;Internationalizing and Localizing Web Applications</a></p>
<p class="toc level1 tocsp"><a href="bnayk.html">Part&nbsp;III&nbsp;Web Services</a></p>
<p class="toc level2"><a href="bnayl.html">16.&nbsp;&nbsp;Building Web Services with JAX-WS</a></p>
<p class="toc level2"><a href="bnazf.html">17.&nbsp;&nbsp;Binding between XML Schema and Java Classes</a></p>
<p class="toc level2"><a href="bnbdv.html">18.&nbsp;&nbsp;Streaming API for XML</a></p>
<p class="toc level2"><a href="bnbhf.html">19.&nbsp;&nbsp;SOAP with Attachments API for Java</a></p>
<p class="toc level1 tocsp"><a href="bnblr.html">Part&nbsp;IV&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbls.html">20.&nbsp;&nbsp;Enterprise Beans</a></p>
<p class="toc level2"><a href="bnbnb.html">21.&nbsp;&nbsp;Getting Started with Enterprise Beans</a></p>
<p class="toc level2"><a href="bnboc.html">22.&nbsp;&nbsp;Session Bean Examples</a></p>
<p class="toc level2"><a href="bnbpk.html">23.&nbsp;&nbsp;A Message-Driven Bean Example</a></p>
<p class="toc level1 tocsp"><a href="bnbpy.html">Part&nbsp;V&nbsp;Persistence</a></p>
<p class="toc level2"><a href="bnbpz.html">24.&nbsp;&nbsp;Introduction to the Java Persistence API</a></p>
<p class="toc level2"><a href="bnbrl.html">25.&nbsp;&nbsp;Persistence in the Web Tier</a></p>
<p class="toc level2"><a href="bnbrs.html">26.&nbsp;&nbsp;Persistence in the EJB Tier</a></p>
<p class="toc level2"><a href="bnbtg.html">27.&nbsp;&nbsp;The Java Persistence Query Language</a></p>
<p class="toc level1 tocsp"><a href="bnbwi.html">Part&nbsp;VI&nbsp;Services</a></p>
<p class="toc level2"><a href="bnbwj.html">28.&nbsp;&nbsp;Introduction to Security in the Java EE Platform</a></p>
<p class="toc level2"><a href="bnbyk.html">29.&nbsp;&nbsp;Securing Java EE Applications</a></p>
<p class="toc level2"><a href="bncas.html">30.&nbsp;&nbsp;Securing Web Applications</a></p>
<p class="toc level2"><a href="bncdq.html">31.&nbsp;&nbsp;The Java Message Service API</a></p>
<p class="toc level2"><a href="bncgv.html">32.&nbsp;&nbsp;Java EE Examples Using the JMS API</a></p>
<p class="toc level2"><a href="bncih.html">33.&nbsp;&nbsp;Transactions</a></p>
<p class="toc level2"><a href="bncjh.html">34.&nbsp;&nbsp;Resource Connections</a></p>
<p class="toc level2"><a href="bncjx.html">35.&nbsp;&nbsp;Connector Architecture</a></p>
<p class="toc level1 tocsp"><a href="bnckn.html">Part&nbsp;VII&nbsp;Case Studies</a></p>
<p class="toc level2"><a href="bncko.html">36.&nbsp;&nbsp;The Coffee Break Application</a></p>
<p class="toc level2"><a href="bnclz.html">37.&nbsp;&nbsp;The Duke's Bank Application</a></p>
<p class="toc level1 tocsp"><a href="gexbq.html">Part&nbsp;VIII&nbsp;Appendixes</a></p>
<p class="toc level2"><a href="bncno.html">A.&nbsp;&nbsp;Java Encoding Schemes</a></p>
<p class="toc level2"><a href="bncnq.html">B.&nbsp;&nbsp;Preparation for Java EE Certification Exams</a></p>
<p class="toc level2"><a href="bncnt.html">C.&nbsp;&nbsp;About the Authors</a></p>
<p class="toc level1 tocsp"><a href="idx-1.html">Index</a></p>
</td>
      <td width="10px">&nbsp;</td>
      <td width="705px">
         <div class="header">
             <div class="header-links-top">
                 <a href="http://java.sun.com">java.sun.com</a> |
                 <a href="http://docs.sun.com/">docs.sun.com</a><br>
             </div> 
             <img src="graphics/tutorialBanner.gif" width="704" height="120" alt="The Java&trade; EE 5 Tutorial"/>
             <div class="header-links">
	         <a href="index.html">Home</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/download.html">Download</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/doc/JavaEETutorial.pdf">PDF</a> |
                 <a href="http://java.sun.com/javaee/5/docs/api/index.html">API</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/faq.html">FAQ</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/search.html">Search</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/sendusmail.html">Feedback</a> |
                 <a href="http://java.sun.com/javaee/5/docs/tutorial/information/history.html">History</a>
             </div>
             <div class="navigation">
                 <a href="idx-8.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
                 <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
                 <a href="idx-10.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
             </div>
         </div>

	 <div class="maincontent">      	 
             <h4>R</h4>
<div class="indexdiv">
<dl>
<dd>RAR files, <a href="bncjy.html#indexterm-3100">About Resource Adapters</a></dd>
</dl>
<dl>
<dd>Read-and-Write, StAX example, <a href="bnbfl.html#indexterm-1883">Read-and-Write Example</a></dd>
</dl>
<dl>
<dd>realms<dl>
<dd><a href="bnbxj.html#indexterm-2475">What Are Realms, Users, Groups, and Roles?</a></dd>
<dd><a href="bnbxj.html#indexterm-2476">What Is a Realm?</a></dd>
</dl>
<dl>
<dd><tt>admin-realm</tt>, <a href="bnbxj.html#indexterm-2480">What Is a Realm?</a></dd>
<dd><tt>certificate</tt>, <a href="bnbxj.html#indexterm-2479">What Is a Realm?</a><dl>
<dd>adding users, <a href="bnbxj.html#indexterm-2495">Adding Users to the Certificate Realm</a></dd>
</dl>
configuring, <a href="bnbxi.html#indexterm-2458">Securing the Application Server</a></dd>
<dd><tt>file</tt>, <a href="bnbxj.html#indexterm-2478">What Is a Realm?</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>recover</tt> method, <a href="bncfu.html#indexterm-2908">Controlling Message Acknowledgment</a></dd>
</dl>
<dl>
<dd>redelivery of messages<dl>
<dd><a href="bncfu.html#indexterm-2902">Controlling Message Acknowledgment</a></dd>
<dd><a href="bncfu.html#indexterm-2907">Controlling Message Acknowledgment</a></dd>
</dl>
<dl>
<dd><tt>JMSRedelivered</tt> message header field, <a href="bnceh.html#indexterm-2858">Message Headers</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>referencing backing bean methods, <a href="bnatn.html#indexterm-1215">Referencing a Backing Bean Method</a><dl>
<dd>for handling action events<dl>
<dd><a href="bnatn.html#indexterm-1250">Referencing a Method That Handles an Action Event</a></dd>
<dd><a href="bnavb.html#indexterm-1436">Writing a Method to Handle an Action Event</a></dd>
</dl>
</dd>
<dd>for handling value-change events, <a href="bnatn.html#indexterm-1259">Referencing a Method That Handles a Value-change Event</a></dd>
<dd>for performing navigation<dl>
<dd><a href="bnatn.html#indexterm-1241">Referencing a Method That Performs Navigation</a></dd>
<dd><a href="bnavb.html#indexterm-1430">Writing a Method to Handle Navigation</a></dd>
</dl>
</dd>
<dd>for performing validation<dl>
<dd><a href="bnatn.html#indexterm-1255">Referencing a Method That Performs Validation</a></dd>
<dd><a href="bnavb.html#indexterm-1446">Writing a Method to Perform Validation</a></dd>
</dl>
</dd>
</dl>
</dd>
</dl>
<dl>
<dd>registering custom converters, <a href="bnaxe.html#indexterm-1597">Registering a Custom Converter</a><dl>
<dd><tt>converter</tt> element, <a href="bnaxe.html#indexterm-1600">Registering a Custom Converter</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>registering custom renderers<dl>
<dd><a href="bnawa.html#indexterm-1534">Delegating Rendering to a Renderer</a></dd>
<dd><a href="bnaxh.html#indexterm-1616">Registering a Custom Renderer with a Render Kit</a></dd>
</dl>
<dl>
<dd><tt>render-kit</tt> element<dl>
<dd><a href="bnaxh.html#indexterm-1622">Registering a Custom Renderer with a Render Kit</a></dd>
<dd><a href="bnaxh.html#indexterm-1623">Registering a Custom Renderer with a Render Kit</a></dd>
</dl>
</dd>
<dd><tt>renderer</tt> element, <a href="bnaxh.html#indexterm-1625">Registering a Custom Renderer with a Render Kit</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>registering custom UI components<dl>
<dd><a href="bnavt.html#indexterm-1488">Steps for Creating a Custom Component</a></dd>
<dd><a href="bnaxi.html#indexterm-1627">Registering a Custom Component</a></dd>
</dl>
<dl>
<dd><tt>component</tt> element, <a href="bnaxi.html#indexterm-1630">Registering a Custom Component</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>registering custom validators, <a href="bnaxd.html#indexterm-1593">Registering a Custom Validator</a><dl>
<dd><tt>validator</tt> element, <a href="bnaxd.html#indexterm-1596">Registering a Custom Validator</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>registering messages, <a href="bnaxb.html#indexterm-1586">Registering Custom Error Messages</a><dl>
<dd><tt>message-bundle</tt> element, <a href="bnaxb.html#indexterm-1589">Registering Custom Error Messages</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>relationship fields, query language, <a href="bnbth.html#indexterm-2250">Query Language Terminology</a></dd>
</dl>
<dl>
<dd>relationships<dl>
<dd>direction, <a href="bnbqa.html#indexterm-2179">Bidirectional Relationships</a></dd>
<dd>unidirectional, <a href="bnbrt.html#indexterm-2222">Unidirectional Relationships</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>release</tt> method, <a href="bnaow.html#indexterm-650">Tag Handler Manipulates the Body</a></dd>
</dl>
<dl>
<dd>reliability, JMS<dl>
<dd>advanced mechanisms, <a href="bncfu.html#indexterm-2930">Using Advanced Reliability Mechanisms</a></dd>
<dd>basic mechanisms, <a href="bncfu.html#indexterm-2899">Using Basic Reliability Mechanisms</a></dd>
<dd>durable subscriptions, <a href="bncfu.html#indexterm-2931">Creating Durable Subscriptions</a></dd>
<dd>local transactions, <a href="bncfu.html#indexterm-2939">Using JMS API Local Transactions</a></dd>
<dd>message acknowledgment, <a href="bncfu.html#indexterm-2900">Controlling Message Acknowledgment</a></dd>
<dd>message expiration, <a href="bncfu.html#indexterm-2921">Allowing Messages to Expire</a></dd>
<dd>message persistence, <a href="bncfu.html#indexterm-2910">Specifying Message Persistence</a></dd>
<dd>message priority levels, <a href="bncfu.html#indexterm-2918">Setting Message Priority Levels</a></dd>
<dd>temporary destinations, <a href="bncfu.html#indexterm-2924">Creating Temporary Destinations</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>remote interfaces, defined, <a href="bnbmg.html#indexterm-2038">Remote Clients</a></dd>
</dl>
<dl>
<dd>Remote Method Invocation (RMI), and messaging, <a href="bncdr.html#indexterm-2783">What Is Messaging?</a></dd>
</dl>
<dl>
<dd>request/reply mechanism<dl>
<dd><tt>JMSCorrelationID</tt> message header field, <a href="bnceh.html#indexterm-2853">Message Headers</a></dd>
<dd><tt>JMSReplyTo</tt> message header field, <a href="bnceh.html#indexterm-2855">Message Headers</a></dd>
<dd>temporary destinations and, <a href="bncfu.html#indexterm-2929">Creating Temporary Destinations</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>request-response messaging, <a href="bnbhg.html#indexterm-1912">SAAJ Connections</a></dd>
</dl>
<dl>
<dd><tt>RequestDispatcher</tt> interface, <a href="bnagi.html#indexterm-283">Invoking Other Web Resources</a></dd>
</dl>
<dl>
<dd>requests, <a href="bnafv.html#indexterm-235">Getting Information from Requests</a><dl>
<dd><i>See also </i>HTTP requests<dd>appending parameters, <a href="bnajc.html#indexterm-405">jsp:param Element</a></dd>
<dd>customizing, <a href="bnagb.html#indexterm-267">Programming Customized Requests and Responses</a></dd>
<dd>getting information from, <a href="bnafv.html#indexterm-238">Getting Information from Requests</a></dd>
<dd>retrieving a locale, <a href="bnaxw.html#indexterm-1650">Establishing the Locale</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>Required</tt> transaction attribute, <a href="bncgl.html#indexterm-2962">Managing Distributed Transactions</a></dd>
</dl>
<dl>
<dd>resource adapter, security, <a href="bncal.html#indexterm-2701">Configuring Resource Adapter Security</a></dd>
</dl>
<dl>
<dd>resource adapters<dl>
<dd><a href="bnacj.html#indexterm-99">J2EE Connector Architecture</a></dd>
<dd><a href="bncjy.html#indexterm-3098">About Resource Adapters</a></dd>
</dl>
<dl>
<dd>application contracts, <a href="bnckb.html#indexterm-3102">Resource Adapter Contracts</a></dd>
<dd>archive files<dl>
<dd><i>See </i>RAR files</dd>
</dl>
CCI, <a href="bnckj.html#indexterm-3122">Common Client Interface</a></dd>
<dd>connection management contract, <a href="bnckb.html#indexterm-3108">Outbound Contracts</a></dd>
<dd>importing transactions, <a href="bnckb.html#indexterm-3119">Transaction Inflow</a></dd>
<dd>life-cycle management contract, <a href="bnckb.html#indexterm-3104">Life-Cycle Management</a></dd>
<dd>messaging contract, <a href="bnckb.html#indexterm-3117">Messaging Contracts</a></dd>
<dd>security management contract, <a href="bnckb.html#indexterm-3113">Outbound Contracts</a></dd>
<dd>system contracts, <a href="bnckb.html#indexterm-3103">Resource Adapter Contracts</a></dd>
<dd>transaction management contract, <a href="bnckb.html#indexterm-3110">Outbound Contracts</a></dd>
<dd>work management contract, <a href="bnckb.html#indexterm-3106">Work Management Contract</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>resource bundles, <a href="bnaxv.html#indexterm-1648">Java Platform Localization Classes</a></dd>
</dl>
<dl>
<dd>resources, <a href="bncjh.html#indexterm-3079">Resource Connections</a><dl>
<dd><i>See also </i>data sources<dd>creating, <a href="bncji.html#indexterm-3081">Resources and JNDI Naming</a></dd>
<dd>injecting, <a href="bncji.html#indexterm-3082">Resources and JNDI Naming</a></dd>
<dd>JMS, <a href="bncgl.html#indexterm-2947">Resource Management</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>responses, <a href="bnafv.html#indexterm-250">Constructing Responses</a><dl>
<dd><i>See also </i>HTTP responses<dd>buffering output, <a href="bnafv.html#indexterm-257">Constructing Responses</a></dd>
<dd>customizing, <a href="bnagb.html#indexterm-268">Programming Customized Requests and Responses</a></dd>
<dd>setting headers, <a href="bnafv.html#indexterm-234">Writing Service Methods</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>Result</tt> interface, <a href="bnald.html#indexterm-499">query Tag Result Interface</a></dd>
</dl>
<dl>
<dd><tt>role-link</tt> element, <a href="bnbyl.html#indexterm-2616">Defining Security Roles</a></dd>
</dl>
<dl>
<dd><tt>role-name</tt> element<dl>
<dd><a href="bnbyl.html#indexterm-2600">Declaring Security Roles Using Deployment Descriptor Elements</a></dd>
<dd><a href="bnbyl.html#indexterm-2613">Defining Security Roles</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>roles, <a href="bnbxj.html#indexterm-2485">What Is a Role?</a><dl>
<dd>anonymous, <a href="bnbyl.html#indexterm-2673">Accessing Unprotected Enterprise Beans</a></dd>
<dd>application<dl>
<dd>mapping to Application Server, <a href="bnbxj.html#indexterm-2520">Mapping Roles to Users and Groups</a></dd>
</dl>
declaring, <a href="bncav.html#indexterm-2728">Declaring Security Roles</a></dd>
<dd>defining, <a href="bncav.html#indexterm-2723">Working with Security Roles</a></dd>
<dd>development<dl>
<dd><i>See </i>development roles</dd>
</dl>
mapping to groups, <a href="bnbxj.html#indexterm-2518">Mapping Roles to Users and Groups</a></dd>
<dd>mapping to users, <a href="bnbxj.html#indexterm-2519">Mapping Roles to Users and Groups</a></dd>
<dd>referencing<dl>
<dd><a href="bnbyl.html#indexterm-2591">Declaring Security Role Names Referenced from Enterprise Bean Code</a></dd>
<dd><a href="bnbyl.html#indexterm-2595">Declaring Security Roles Using Annotations</a></dd>
<dd><a href="bncav.html#indexterm-2734">Declaring Security Roles</a></dd>
</dl>
</dd>
<dd>security<dl>
<dd><a href="bnbyl.html#indexterm-2587">Declaring Security Role Names Referenced from Enterprise Bean Code</a></dd>
<dd><a href="bnbyl.html#indexterm-2604">Defining a Security View of Enterprise Beans</a></dd>
<dd><a href="bncav.html#indexterm-2721">Working with Security Roles</a></dd>
<dd><a href="bncav.html#indexterm-2730">Declaring Security Roles</a></dd>
</dl>
<dl>
<dd><i>See </i>security roles<dd>declaring, <a href="bnbyl.html#indexterm-2597">Declaring Security Roles Using Deployment Descriptor Elements</a></dd>
<dd>setting up, <a href="bnbxj.html#indexterm-2497">Setting Up Security Roles</a></dd>
</dl>
</dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>rollback</tt> method<dl>
<dd><a href="bncij.html#indexterm-3043">Methods Not Allowed in Container-Managed Transactions</a></dd>
<dd><a href="bnciy.html#indexterm-3060">JTA Transactions</a></dd>
<dd><a href="bnciy.html#indexterm-3067">Methods Not Allowed in Bean-Managed Transactions</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd><tt>rollback</tt> method (JMS), <a href="bncfu.html#indexterm-2943">Using JMS API Local Transactions</a></dd>
</dl>
<dl>
<dd>rollbacks, <i>See </i>transactions, rollbacks</dd>
</dl>
<dl>
<dd><tt>run-as</tt> element<dl>
<dd><a href="bnbyl.html#indexterm-2646">Propagating Security Identity</a></dd>
<dd><a href="bnbyl.html#indexterm-2662">Using Enterprise Bean Security Deployment Descriptor Elements</a></dd>
</dl>
</dd>
</dl>
<dl>
<dd>run-as identity, <a href="bnbyl.html#indexterm-2640">Propagating Security Identity</a></dd>
</dl>
</div>
         </div>
         <div class="navigation">
             <a href="idx-8.html"><img style="padding-right: 3px" src="graphics/leftButton.gif" border="0"></a>
             <a href="sjsaseej2eet.html"><img style="padding-right: 3px" src="graphics/upButton.gif" border="0"></a>
             <a href="idx-10.html"><img style="padding-left: 3px" src="graphics/rightButton.gif" border="0"></a>
         </div>

         <div class="copyright">
      	    <p>The material in The Java&trade; EE 5 Tutorial is <a href='docinfo.html'>copyright</a>-protected and may not be published in other works without express written permission from Sun Microsystems.</p>
      	 </div>

      </td>
   </tr>
</tbody>
</table>
</body>
</html>

